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SIGNAL CORPS RECOMP ASSEMBLY PROGRAM 

SCRAP II 

by 

T. J. TOBIAS, U. S. ARMY SIGNAL ENGINEERING AGENCY 

INTRODUCTION : SCRAP is an assembly program for the RECOMP II computer. 
It is designed to use mnemonic operation codes and symbolic, absolute, 
operand, or relative addresses. SCRAP uses all of the RECOMP II 
commands, as well as pseudo-operation codes and macro-instructions. 
The SCRAP processor requires two passes to complete the assembly of 
a program written in the SCRAP language. The primary working media 
of the SCRAP processor during assembly is paper tape for both input 
and output data. Printed output is optional during both the first 
and second passes of assembly. 

DESCRIPTION : 

1. The SCRAP processor allows for an extremely flexible instruc- 
tion format. Each line of SCRAP programming may have a symbolic 
location of up to eight alphabetic characters, a command, and an 
address of any one of six (6) types. For example, if a floating point 
number in location 10^2 is to be multiplied by the decimal number, 
-ll*39h 9 and the result stored in a data area, this program might be 
written as follows: 



LOCATION 


COMMAND 
FCA 


T 
N ' 


ADDRESS 


REMARKS 




10^2 


C(10£2,3) to A,R 




FMP 


F 


-71.39k 


C(A,R) x (-71.39U) 




FST 


S 


DATA 


C(A,R) to DATA 



These three instructions generally illustrate the major type of 
'address 1 permitted in SCRAP; that is, absolute (N) addresses, 
symbolic (S) addresses, and operand (F,D,C,A) addresses. As maybe 
noted, four (li) types of operand addresses are allowed. These will 
provide a means of entry for almost all types of data encountered in 
the programming of the RECOMP II computer. The permissible types of 
operand addresses are: 

F - - Floating Point Numbers 



D - - Fixed Point Numbers 



C - - Command Format Data 

A - - Alphabetic (Baudot) Data 

As an illustration of programming using SCRAP, following is a 
subroutine for the assemoly of a floating point number where the 
C(A) is the integer part at 39 and the C(R) is the fractional part 
at 0. 

REMARKS 

C(A) to TEMPSTO 

Return address +1 @ 39 

Store to exit line 

C(R) to A 

C(A) to TEMPSTO+1 

+39 @ 39 to R 

Integer Part to A 

Integer Part to Normalized FP 

Integer + Fractional Part to FP 

Set Next Instruction Right 

Exit Line 

TS for integer part 

TS for fractional part 

+0000000-0000000 Exponent of zero for fractional part 

Constant of +39 @ 39 

^Zero in command format is to illustrate the use of the 
C type address in this example. 



LOCATION 


COMMAND 


T 


ADDRESS 


FIXT0FL0 


SAX 


S 


TEMPSTO 




ADD 


D 


+1+39 




STA 


S 


EXIT 




XAR 


N 







STO 


S 


TEMPSTO+1 




FCA 


S 


CONSTANT 




CLA 


S 


TEMPSTO 




FNM 


N 







FAD 


S 


TEMPSTO+1 




SR 






EXIT 


TRA 


N 





TEMPSTO 


DECIMAL 


D 


+0+0 




DECIMAL 


D 


+0+0 


CONSTANT 


COMMAND""" 


C 


+0000000-( 




DECIMAL 


D 


+39+39 



This program contains many of the permissible types of instructions which 
may be used when programming in the SCRAP language. Of particular note 
in the example is the use of the relative address, * TEMPSTO+1 1 , which 



refers to the location one (l) word beyond the location named 
'TEMPSTO'. Relative addressing of both full and half words from 
00001 to 77771 is permitted relative to any symbolic address. 

2, The four fields of data of a SCRAP program, LOCATION, COMMAND, 
T, and ADDRESS, may contain the following information: 

a. LOCATION ; The location may contain a symbolic 'tag* to 
identify a memory location. This field may contain from 
one (1) to eight (8) alphabetic characters (A-Z) . The 
typewriter functions, figures shift, carriage return, tab, 
and blank, 02, are not allowed. The letter 'C 1 should not 
be used as a location symbol since this character is 
reserved as a special address symbol. The location field 
may be blank, 

b. COMMAND ; The command field must contain a mnemonic opera- 
tion code, pseudo-operation code, or macro-instruction 
which is recognized by SCRAP. In addition to the RECOMP II 
operation codes the following are permissible: 



COMMAND DEFINITION 

HALT same as HTR 

HLT same as HTR 

DISC DIS - Command format 

DISD DIS - BCD format 

TYWC TYW - Command format 

TYWD TYW - BCD format 

PMC PNW - Command format 

PNWD PNW - BCD format 

PTWC PTW - Command format 

PTWD PTW - BCD format 

Note: DIS, TIW, PNW, and PTW will be assembled 
as command format. The complete list pseudo- 
operation codes is described in paragraph 3, 
and the macro-operation codes are discussed in 
paragraph lu 



c. TYPE OF ADDRESS FIELD, T : This code specifies the type 
of address used in the address field. The following 
six codes are used: 



TYPE CODE TYPE OF ADDRESS 

S Symbolic 

N Absolute Numeric Address, Octal and half word bit 

D Fixed point decimal 

F Floating point decimal 

C Command format 

A Alphabetic 



The type of address field may be blank; if it is, the 
address will be interpreted as symbolic. 

d. ADDRESS : The address field may contain any one of the six 
types of data identified above. The required format of 
these data is as follows: 

(1) SYMBOLIC : A symbolic address may contain from one (l) 
to eight (8) alphabetic characters (A-Z), The type- 
writer functions figures shift, carriage return, tab, 
and blank, 02, are not permitted, A symbolic address 
may in addition have an increment or decrement applied 
to it at assembly time. The increment or decrement 
must have the same form as an absolute address. For 
example: 



ADDRESS REMARKS 

EXIT A reference to the location named 'EXIT 1 

TEMPSTO A reference to the location named 'TEMPSTO 1 

TEMPST0+1 The location one word beyond » TEMPSTO 1 

EHT-00001 one half word back from »EXIT» 

AREA-00021 Two and one half words back from 'AREA 1 

The special address 'C 1 may be used to refer to 
locations relative to the present instruction. 



For example: 



LOCATION 


COMMAND 


T 


ADDRESS 




CLA 




DATA 




TPL 




C+l 




TRA 




OUT 




TZE 




C+l 




TRA 




OUT 




ANYOP 







REMARKS 

C(DATA) to A 

Are C(DATA) plus? 

C(DATA) are not plus 

Are C(DATA) both plus and zero? 

C(DATA) are plus but not zero 

C(DATA) are plus and zero 



This sequence of instructions illustrates a comparison 
operation to determine if the contents of location 
DATA are plus zero. The use of the special address 
form , C I allows for relative addressing to the present 
instruction and in this case eliminates the need to 
write the two location 'tags 1 which would have been 
required without this 'self -relative 1 feature. 

(2) ABSOLUTE NUMERIC ADDRESS ; An absolute numeric address 
field may contain from one (l) to five (f?) numeric 
characters. The first four characters of the field 
must be an octal address. The last character of the 
field represents the half word bit as in the normal 
RECOMP command format. If the field is less than five 
(5) characters, it will represent an octal address, 
right justified, and with the half word bit of zero. 
For example: 

ABSOLUTE ADDRESS EQUIVALENT COMMAND FORMAT 



7760 


7760.0 


3 


0003.0 


7U5 


071+S.0 


£7021 


5702.1 


00001 


0000.1 





0000.0 



(3) FIXED POINT DECIMAL : A fixed point decimal number 
used in the address field may contain a maximum of 
sixteen (16) characters including the sign, 
decimal point, and location of the binary point. 
In addition, neither the integer nor the fractional 
part of the number may contain more than eleven 
(11) characters. The location of the binary point 
is specified by the use of the suffix ±BB. The 
general form of a fixed point decimal number is 
±IIII.FFFF±BB. The leading sign may be omitted 
if the number is positive. If the location of the 
binary point is omitted, however, the number will 
be converted as a floating point decimal number 
but will only be allocated one word of storage. 
There are no error halts for this situation. Ex- 
amples of fixed point decimal numbers are as 
follows : 



ADDRESS 



MEANING 



+1+39 


+1 @ 39 


1+20 


+1 @ 20 


-100+38 


-100 @ 38 


-.1-3 


-0.1 @ -3 


0.12S+0 


+0.12£ @ 



RESULTANT COMMAND FORMAT 
+0000000-0000001 
+0000000+0000000 
-OOOOOOO-OOOlUUO 

-631U630-631U630 

+1000000-0000000 



If the specified binary point would cause the loss 
of significant (left hand) bits, the number will 
not be converted as specified. There will be no 
error halt or error indication. 

(U) FLOATING POINT DECIMAL : A floating point decimal 
number used in the address field may contain a 
maximum of sixteen (16) characters including sign 
and decimal point. Neither the integer part of 
the number nor the fractional part may contain 
in excess of eleven (11) characters. The sign may 
be omitted if the number is positive. Examples 
of floating point decimal addresses are as follows: 



ADDRESS 



+1 



MEANING 



+1 



RESULTANT COMMAND FORMAT 
+U000000-0000000 



+0000000-0000001 



ADDRESS MEANING RESULTANT COMMAND FORMAT 

-0.25 -0.25 -Uoooooo-0000000 

-0000000-0000001 

100 +100 +6200000-0000000 

+0000000-0000031 

-10.75 -10.75 -5300000-0000000 

+0000000-0000020 

(5) COMMAND : A word of command format data may be used 
in the address field. It will be assembled exactly 
as specified. For example: 

ADDRESS RESULTANT COMMAND FORMAT 

+7766010-123U561 +7766010-123U561 
-0000000+7777UOO -0000000+7777U00 

If a non-octal numeric character is entered as command 
data, it will be assembled in the command limited to 
its three low order bits. That is, eight would be 
assembled as zero and nine as one. There are no 
error halts or other indications of this condition. 

(6) ALPHABETIC : An address field may contain from zero 
(0) to eight (8) alphabetic characters. These will 
be assembled in the baudot code form with the data 
right justified. The characters carriage return, 
tab, and blank, 02, are not permitted. Examples 

of alphabetic data are as follows: 

ADDRESS RESULTANT COMMAND FORMAT 

AREA -OOOOOOO-O52O2II 

Z -0000000-0000101 

ANIPLACE -15U5531+1033U01 

3. SCRAP contains a number pseudo-operation codes which cause 
certain functions to be performed by the SCRAP processor at assembly 
time. These functions may also cause some object code to be produced. 



The following is the SCRAP repertoire of pseudo-ops. 

PSEUDO-OPERATION DEFINITION 

ORG ORIGIN t This pseudo-operation code will cause 
the next instruction to be assembled in the 
location specified by the address part of the 
ORG pseudo -operation. The address of this 
command must be numeric. For example: 

LOCATION COMMAND T ADDRESS 

ORG N £00 

This will cause the next instruction to be 
assembled in 0^00.0 

DEF DEFINITION t This command specifies that the 
symbolic location in the LOCATION field is 
defined to be the absolute address specified 
in the address field. For example: 



LOCATION 


COMMAND 


T 


ADDRESS 


START 


DEF 


N 


1200 


L 


DEF 


N 


7760 


DATA 


DEF 


N 


£000 



The LOCATION field must be symbolic and the 
ADDRESS field must be a numeric absolute 
address* 

EQU EQUIVALENCE : This pseudo-operation code identif- 
ies two symbols as being equivalent. The two 
symbols so identified may be used interchangeably. 
For example: 

LOCATION COMMAND T ADLRESS 

DATAAREA EQU S DATA 

TS EQU S TEMPSTO 



SL 



SR 



SB 



END 



PAUSE 



ALPHA or ALF 



DECIMAL or DEC 



The symbol in the LOCATION field should be 
identified by the equivalence pseudo-operation 
before it is used in the program or it may not 
be recognized and assembled correctly, 

SET LEFT : This command will cause the next in- 
struction to be assembled in the left hand side 
of the word. This command may cause an 
ARS 0000,0 to be assembled as a dummy instruction 
if required to cause the set left operation, 

SET RIGHT : This command will cause the next 
instruction to be assembled in the right hand 
side of the word. As in the case of the SL 
pseudo-operation code, this may cause a dummy 
of ARS 0000.0 to be generated, 

SET BLOCK : This command will cause the next in- 
struction to be assembled in the left side of the 
next modulo eight word. Such dummy instructions 
as may be generated will be ARS 0000.0 

This pseudo-operation code signifies the end of the 
data to be assembled. No other operation may follow 
the END pseudo-operation code. 

This operation code will cause the SCRAP processor 
to stop assembling. Restart is accomplished by 
depressing the start button. 

ALPHABETIC DATA : This pseudo-operation code indi- 
cates that the address field contains alphabetic 
data. The type code must be A. 

DECIMAL DATA : This command indicates that the address 
field contains decimal information. The type code 
must be either an F or a D. 



COMMAND or COM 



COMMAND DATA : This pseudo-operation code indicates 
that the command field contains command format data, 
The type code must be C. 



lu SCRAP II also allows for the use of macro-instructions. These 
may cause the production of several lines of coding for each macro that 
is given. The macros are used in the same manner as normal operation 
codes. If the macro has several arguments these are listed in successive 
address fields. For example: 



LOCATION 



COMMAND 



ADDRESS 



anytag 



TNZ 



any permissible 



Operation code Transfer on 
non-zero 



LOCATION COMMAND T ADDRESS 

anytag ZMT any permissible Operation code Zero mode transfer 

anytag SAM no. argument Operation code Set A Register 

minus 

The detailed discussion of the construction of macro instruction is con- 
tained under the operating procedures for macros. 

5>. The SCRAP processor requires two passes to complete the assembly 
of the program. During the first pass an assignment table is accumulated 
in which all the symbolic references are listed. If the symbol has also 
been used as a location tag then an absolute assignment for that symbol 
is stored. If a symbolic address is not also used in the program as a 
location, no specific assignment may be made. These symbols will be 
referred to as unassigned symbols. Also during the first pass a table 
of equivalences is constructed for use during both the first and second 
passes. During the first pass all operand addresses are replaced by 
names. That is, the first fixed point constant encountered in the program 
is assigned the name •FIXCN01 1 '. This name is also substituted on the 
output tape for this constant. The floating point constants are assigned 
the name ■FLOCNnn 1 , the alphabetic constants the name 'ALFCNnn 1 , and the 
command format constants the name ■COMCNnn 1 . Each different constant is 
only named once and becomes a part of a constant pool. The macro in- 
structions are also expanded to their full representation. At the end 
of the first pass all of the constants used as operand addresses are 
assigned locations immediately after the end of the program locations. 
The assignment table is then printed out. All unassigned symbols may 
be assigned absolute locations at this time (during the printing opera- 
tion) or the assignment table may be printed a second time with 
assignment of all unassigned symbols taking place at that time. This 
feature of assignment of unassigned symbols or non-assignment at the 
programmer's option allows for checking of mispelling, omissions, or 
other errors which may not be obvious if all unassigned symbols are 
assigned. A good procedure is to obtain a listing of the assignment 
table first without assignment of the unassigned symbols, and then a 
second listing with assignment if desired. A listing of all operand 
addresses and the corresponding names is also printed out for cross 
reference and checking purposes. 

6. During the second pass all instructions and data are converted 
to the correct command format. The assignment table is used to obtain 
the corresponding absolute address for all symbolic addresses. 
Absolute addresses and data are converted to the proper command format 
words. An output listing of the assembly is optional during this 
pass. The object program is punched into paper tape in command 
format. 

?• Insertions and deletions may be made during the first pass. 
This is accomplished by use of a preset stop to the beginning of the 
first pass program and by inputing the necessary corrections, additions^ 

10 



or deletions from the typewriter. This allows for the reassembly of 
a program, requiring minor changes, without having to re-keypunch the 
entire input tape. 

8. At the end of either the first or second pass a copy of all 
significant tables and other data may be obtained on paper tape. This 
will allow for the continuation of assembly at some later time begin- 
ning at the point where the previous program ended, or will allow the 
first and second passes of assembly to be accomplished on a non- 
continuous basis. 



SUMMARY ; The SCRAP processor provides for an extremely flexible instruction 
format, including provisions for symbolic, absolute, operand, and 
relative addresses. The SCRAP processor also provides for corrections, 
insertions, and deletions during the first pass of assembly and for 
assembly of a program in sections. This assembly program also provides 
for the use of macro-instructions which may, if desired, be constructed 
for only one time use. These features make the SCRAP assembly program 
an extremely flexible aid to programming and provides a base for even 
more complex automatic programming systems. 



11 



SIGNAL CORPS RECOMP ASSEMBLY PROGRAM, SCRAP II 

APPENDIX I 

SCRAP OPERATING INSTRUCTIONS 



1. GENERAL ; The SCRAP processor has several modes of operation 
and also provides for a number of options during (or after) processing. 
These operating procedures contain information regarding the following: 

a. "Key Punching" paper tape with SCRAP, 

b. Procedures for the First Pass. 

c. Procedure for the Second Pass. 

d. Insertions, Deletions, and Corrections during the First Pass. 

e. Dumping of the Assignment Table and other Data. 

f. Construction of Macro-Instructions. 

g. Restrictions and Program Halts. 

2. KEY-PUNCHING SCRAP INPUT TAPE : The SCRAP program may be used to 
process input from the typewriter and produce a paper tape in the proper 
format for later assembly. The SCRAP processor reads and edits the input 
information from typewriter, performs a cursory check for errors, and 
produces the properly formated paper tape. 

a. Key Punching 



(i 

(2 
(3 
(4 
(5 
(6 
(7 
(8 
(9 



Clear locations 0500-4277 to negative zero. 

Load SCRAP II Program. 

Set sense switch B and C on; Sense D off. 

Set typewriter margin at 10; tabs at 20, 29» and 32. 

Depress START 1 to begin. 

Type command field and tab (or tab if blank). 

Type command field and tab. 

Type "T" field and tab (or tab if blank). 

Type address field and a carriage return. The output 
paper tape will be punched at the completion of the 
carriage return. 



(10) Repeat steps 6 through 9. 

(11) If an error is made and detected before the carriage 
return at the end of the line, it may be deleted by- 
depressing the blank key immediately to the right of 
the H M" Key. ^he line is then retyped. 

(12) No error may be corrected after the carriage return 
as the data is already on tape. 

(13) If , as a result of typing too quickly, an output error 
is caused, this condition may be corrected by: 

(a) Depressing error reset; then 

(b) Depressing START 1, and then 

(c) Depressing the blank key next to the "M" Key. 
The line may now be retyped by following steps 6 
through 9» 

b. Termination Key Punching 

(1) If the last entry on tape is the pseudo-operation END, 
the tape may be terminated by: 

(a) Tabbing blank fields until the end of group ter- 
mination occurs (Output is grouped on tape 16 
lines of coding per group). 

(b) Or, by setting the punch to manual and punching 9 
blanks (00) , L 77000, carriage return, 3 blanks 
(00), and an »S M . 

(2) If the program is to be key-punched in sections, each 
section may be terminated as follows: 

(a) Type a line of coding with the pseudo-op PAUSE. 

(b) Tab at least one blank line of coding (no command 
or T field data). 

(c) Terminate by either one of methods outlined in (l) 
above. 

(d) Clear location 5013 to +zero before restarting. 

It should be noted that the PAUSE line is not essential but is a useful 
means of stopping assembly while the next section of paper tape is 
placed in the photo reader. The blank line is necessary in that the 
absence of a command field causes the reading of a new group from paper 



tape. During assembly the PAUSE causes a temporary stop and after 
the loading of the photo reader, assembly is restarted by depressing 
the start button. 

3. FIRST PASS : The first pass of the SCRAP assembly allows for 
optional input and output methods as well as the optional assignment of 
unassigned symbols. Insertions, corrections, and deletions may also be 
made during the first pass. These changes are discussed in greater 
detail in paragraph 5 below. The setting of the sense switches de- 
termines the choice of options in the first pass as follows: 

B C 

a. Paper tape Input Only. off off 

b. Typewriter Input Only off on 

c. Paper tape Input and Typewriter on off 
Output . 

d. Key Punch only (No Assembly) on on 

Paper tape output occurs for all forms of input. Option (d) above is 
included in the list of sense switch settings for comparison purposes 
only since no assembly occurs when using this option. The assignment 
of unassigned symbols will occur only after the pseudo-operation END 
and only if sense D is on. In practice it may be preferable to obtain 
a copy of the unmodified assignment table first, and then to exercise 
the assignment of unassigned symbols option. The first pass operating 
procedure is as follows: 

(1) Clear locations 0500-4277 to negative zero. 

(2) Load SCRAP program. 

(3) Set sense switches, typewriter margin and tabs and 
load tape into photo reader. 

(4) Depress START 1 to begin assembly. 

(5) When the pseudo-op END occurs the SCRAP processor 
will perform the following actions: 

(a) Print a list of all constants, then 

(b) Print the assignment table 

(c) Print END FIRST PASS and halt. 

(6) A second copy of the assignment table may be obtained 
by depressing the start button (or starting at 4513). 
The position of Sense D may be changed if desired. 



4. SECOND PASS : The second pass completes the assembly operation. 
The input to this pass is the output tape from the first pass. The 
output from the second pass is a copy of the object program on paper 
tape in command format. The Second Pass Procedure is as follows: 

a. Load SCRAP program and assignment table (this is necessary 
only if the first and second passes have not been run 
continuously) . 

b. Load photo reader with output tape from the first pass. 

c. Set typewriter tabs and sense switches (Sense C off and 
B either on or off.) 

d. Depress START 2 to begin. 

e. Assembly will proceed until the END pseudo-op occurs. 

5. INSERTIONS, DELETIONS, AND CORRECTIONS : Changes may be made 
to the program during the first pass of original assembly or during a 
reassembly of the program. It requires that the input media be punched 
paper tape and that the optional printed listing of assembly be 
allowed (at least partly). Procedures for these changes are as 
follows : 

a. Set Sense Switch B on and C off. 

b. Set Read Out Knobs to location 4600. 

c. For a deletion: 

(1) Set Preset Stop to 4600.1. 

(2) After the line to be deleted has been printed and 
the computer stops, depress START 1 to cause a 
deletion. Repeat if necessary. 

(3) Set Preset Stop to neutral and depress START to resume 
assembly. 

d. For an Insertion: 

(1) Set preset stop to 4600.0. 

(2) When the computer stops at the point of the insertion; 

(a) Set preset stop to neutral. 

(b) Set sense switch B off and C on. 



(c) Depress START. 

(3) Type insertion(s) from typewriter. 

(4) Terminate the insertion operation by a PAUSE pseudo- 
operation. 

(5) Set sense switch B on and C off and then depress START 1 
to resume assembly. 

e. For a Correction: 

(1) Set Preset Stop to 4600.1. 

(2) After the line to be corrected is printed and the 
computer stops; 

(a) Set Sense Switch B off and C on. 

(b) Set Preset Stop to neutral. 

(c) Depress START 1. 

(3) Type correction from typewriter. 

(4) Terminate the correction operation by use of the PAUSE 
pseudo-operation . 

(5) Set Sense Switch B on and C off and then Depress 
START 1 to resume assembly. 

f . Changes may also be made to the assignment table at the end 
of the first pass. For example, a mispelling might cause 

the following entries in the printout of the assignment table! 

SCAN B 40000000-0035620 

SYMBLOIC -0000000-0000000 

GETPAREN +0000000-0036120 

SYMBOLIC +0000000-0036000 

GETITEM +0000000-0036701 

The second entry above, "SYMBLOIC", is the result of mis- 
pelling the wor d ''SYMBOLIC". Since the two are equivalent 
names, the command format word, +0000000-0036000, may be 
entered in place of the - zero word. The assignment table 



begins in location 0500 and contains two word items for each 
symbol, the first word being the name of the symbol and the 
second word the assignment. Thus, a manual search of memory 
will uncover the location of the particular unassigned symbol 
and the correction may be entered from the console. This pro- 
cedure will save reassembly time for relatively minor errors 
of mispelling or omission. 

6. DUMPING OF ASSIGNMENT TABLE : The assignment table and other 
significant data may be dumped on paper tape by use of a SAVE program. 
This will allow sectional processing of the first pass or interrupted 
processing of the first and second passes. The SAVE program is started 
by use of the START 3 button. Restart of assembly may be accomplished 
at some later time by filling the SAVE tape after loading the SCRAP 
program tape, thus restoring the program to its previous state. 

7. CONSTRUCTION OF MACRO-INSTRUCTIONS : Macro-instructions may be 
added to the SCRAP II list of operation codes by adding an appropriate 
definition of the macro to the SCRAP II processor. In general, a macro 
consists of a name and a list of arguments as follows: 



tag MACRONAME A#l 
A#2 
A#3 

« 
A#n 
This generates a list of instructions of the following form: 

tag MACHINECODE Xfe 
MACHIHECODE X#n £ 



MACHINECODE X#n 
m 

Where, the X#n's are either from the list of arguments A#n or from 

the list of possible machine (assembly) addresses. The macro, transfer 

on non-zero, TNZ, might be written as follows: 

MACRO: tag TNZ A#l; and produce 



OBJECT CODE: tag T2E C+l 

TRA A#l 
This would generate the following code for various definitions of A#l; 

TNZ N 7770 would generate TZE C+l 

TRA N 7770 

TEST TNZ NODATA would generate TEST TZE C+l 

TRA NODATA 

b. The interpretation of the macro-instruction depends upon 
the definition coding of the macro. This skeleton coding 
is entered into the SCRAP II processor in the format used 
for instructions in SCRAP. In addition, a new instruction 
form for the Arguments (A#n's)-is added for use in the 
skeleton coding (This address form never appears externally 
from the processor). In addition to the definition (skel- 
eton coding) of the macro, the name and limits of the macro 
must be added to the list of operation codes of SCRAP. A 
macro-instruction, therefore, must be added to the list of 
operation codes and the definition coding of the macro 
must be available to the SCRAP II processor. 

c. The operation code table entry must have the following form: 
First Word MACRONAMB (7 character maximum) 
Second Word +aa67100+ppssss0 (command format) 

where, aa number of arguments 

pp number of resulting instructions 
ssss location of definition 

The entry requires two words. The first word is in alpha- 
betic form and contains the name of the macro. The second 
word defines the limits of the macro and the location of 
macro definition. Locations 0330-0475 are the available 
for op table entries referring to macros. This table must 
be extended continuously and the two words after the last 
entry must be negative zero. 



d. The macro definition coding consists of three word entries 
in the following form: 



First Word 
Second Word 
Third Word 



AbbbbRRR 

( ) 
( address) 

( ) 



where, A is an appropriate code corresponding, in function, 
to the type of address code; and, RER is a RECOMP II opera- 
tion code, (b is used here to represent a blank, (X)). 

The six SCRAP II address forms are permitted in the 
address part, as well as a special address form for the 
argument numbers. The format for macro definition coding 
is as follows: 



TYPE OF ADDRESS 
Symbolic 

Numeric 

Command 

Fixed Point Decimal 

Floating Point Decimal 
Alphabetic 

Argument 



CODE A 



ADDRESS FORMAT 



B 


SYMBOLIC # 
bbbbbbbb 


E 


+bbnnnnn 
bbbbbbbb 


H 


+CCCCCCC 




HhCCCCCCC 





f number j 


D 


* number* 


L 


AAAAAAAA 
bbbbbbbb 


b 


+5400000-OOOOOnO 
bbbbbbbb 



*This second word may be an increment or decrement 
of the form +bbnnnnn. 

Locations 7000 to 7577 are available for storage of macro 
definitions. This allows for a maximum of 192 lines of 
macro coding definitions. 
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e. The TNZ macro could be written in the following form: 



MACRO 






OBJECT CODE 


tag TNZ 


A#l 


tag 


TZE C+l 
TRA A#l 


LOCATION COMMAND 


T 


ADDRESS 


REMARKS 


ORG 


N 


0030 




ALP 


A 


TNZ 


MACRONAME 


COM 


C 


+0167100+02700000 


OP TABLE CODE WORD 


ORG 


N 


7000 




ALP 


A 


TZE "■ 


) 


ALF 


A 


C 


C TZE C+l 


ALP 


A 


+bbbbblb ^ 


) 


ALP 


A 


TRA — 


) 


COM 


C 


+5400000-0000010 


(. TRA A#l 


ALP 


A 




1 



END 



This definition of the macro TNZ may be keypunched using 
SCRAP; and, in the above form (only data (ALF, DEC, or 
COM) or location, ORG, pseudops), it may be translated 
to an object tape by using pass two only of SCRAP. 

f. A macro to set the A register minus, SAM, might be 
written as follows: 



MACRO 



OBJECT CODE 



tag 



SAM 



tag EXT 



C-7777771+7777771 



LOCATION 


COMMAND 


T 


ADDRESS 


REMARKS 




ORG 


N 


0332 






ALF 


A 


SAM 


MACRONAME 




COM 


C 


+0167100+0170060 


OP TABLE CODE WORD 




ORG 


N 


7006 






AEF 


A 


HbbbbEXT "*^\ 


i 




ALP 


A 


-7777771 > 


» EXT C-77777... 




ALP 


A 


+7777771 J 





g. A macro to move a block (8 words) to the L loop and 
to transfer to 7760 (ZMT) might be written as 
follows : 



MACRO 




OBJECT CODE 


tag ZMT 


A#l 


TAG CTL A#l 
TRA 7760 
SB 


LOCATION COMMAND 


T 


ADDRESS REMARKS 


ORG 


N 


0334 


ALP 


A 


ZMT MACRONAME 


COM 


C 


+0167100+0370110 OP TABLE CODE WORD 


ORG 


N 


7711 


ALP 


A 


^ 


COM 


C 


+5400000-0000010 ( CTL A#l 


ALF 


A 


3 


ALF 


A 


EbbbbTRA "*~x 


ALP 


A 


+bb7760b C TRA N 7760 


ALP 


A 


J 
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LOCATION 



COMMAND 
ALP 
ALP 
ALP 



T 
A 
A 
A 



ADDRESS 



SB 



REMARKS 



SB 



h. A macro to increment a counter (COUNT) might be 
written as follows: 



MACRO 


m 


OBJECT CODE 


tag COUNT 


tag CLA A#l 




A#2 


ADD A#2 
STO A#l 


LOCATION COMMAND 


T 


ADDRESS REMARKS 


ORG 


N 


0336 


ALF 


A 


COUNT MACRONAME 


COM 


C 


+0267100+0370220 OP TABLE CODE WORD 


ORG 


N 


7022 


ALP 


A 


CLA V 


COM 


C 


+5400000-0000010 ( CLA A#l 


ALP 


A 
A 


J 


ALP 


ADD "\ 


COM 


C 


+5400000-0000020 ( ADD A#2 


ALP 


A 
A 


J 


ALP 


STO "^ 


COM 


C 


+5400000-0000010 ( STO A#l 


ALP 


A 


\ 
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i. The macro instructions written for SCRAP II must observe 
the following restrictions: 

(1) No macro may use another macro in its definition 
coding. 

(2) A macro may have a maximum of 12 arguments. 

(3) A macro must produce at least one line of output 
coding. 

(4) If a macro may have a location tag, the definition 
coding may not begin with SR, SL, SB, PAUSE, or 
ORG. 

j. If it is desired, pseudo-ops may be added to SCRAP II 
which will cause a minus op code to be produced in the 
object code. These will require only an entry in the 
op code table in one of the following forms: 

(1) First Word OPNAME 

Second Word +0046360+cc65120 

In this form the half word bit will be preserved 
as is required for TRA, TZE, STA, etc, 

(2) First Word OPNAME 

Second Word +0046360+cc65060 

In this form the half word bit will always be set 
to zero. 

(3) First Word OPNAME 

Second Word +0046360+cc65l60 

In this form the half word bit will always be set 
to one. where, +cc is the minus op code. For 
example, if a long right shift, LRS, is to be 
added to the repertoire with an op code of -40. 
This could be written as follows (in SCRAP nota- 
tion) : 

ORG N 0330 

ALF A LRS 

COM C +0046360-4065060 
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(Assuming locations 0330-0331 are available in 
the op table) 

The address parts of the minus op codes will be 
handled in exactly the same manner as a normal 
RECOMP II op code, A minus op which requires a 
full word may need to be prefaced with a SL 
pseudo-op. Also, the configuration of the 
"address" of the minus op must necessarily cor- 
respond to at least one of six of the permissible 
SCRAP II address forms. The name given to the op 
code may not exceed seven characters. The name 
may include a figures shift. The name of a pseudo- 
op or macro may, therefore, be any one of the 
following forms: 

TNZ 

SET3 

7X2 

ARS+ 

-00 

Thus, the pseudo-op named -00 could be defined 
to have the absolute value of -00. The value 
assigned to any op code is determined solely by 
the entry in the op code table 

8. RESTRICTIONS AND PROGRAMMED HALTS : 

a. The following are the restrictions referring to the number 
items. Each of these has a related Error Halt. These 
restrictions are as follows: 

(1) Maximum of 512 Symbolic Names 

(2) Maximum of 256 constants and no more than 99 of 
any one type (A, D, F and C). 

(3) Maximum of 64 Equivalences. 

b. The SCRAP II programmed halts are as follows: 

LOCATION INDICATION ERROR CONDITION CORRECTIVE ACTION 

4334.0 (...01..)* More than 512 Symbols No immediate action; 

segment program 
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LOCATION INDICATION 



ERROR CONDITION 



CORRECTIVE ACTION 



7777.0 

7777.0 
UU23.1 

7777.0 

7777.0 

U600.0 
U720.0 



651*0.1 



651*5.1 



0000.0 



(...02..) 

(...03..) 
(...Ol*..) 

(...05..) 
(...06..) 



"ILLEGAL 
OP CODE" 

None 



None 



None 



None 



Search Error of Constant 
Pool 



More than 256 Constants 



Location Counter greater 
than 7757.1 



Search error of equi- 
valence Table 



More than 61* Equivalences 



No find OP CODE 



More than 99 Constants 



Location not in 
Assignment Table 

Address not in 
Assignment Table 



Possible paper tape 
read error 



'Displayed on Console 

c. The SCRAP II normal halts are as follows: 
LOCATION INDICATION 



Clear memory? 
Restart at 1*31*5.1 to 
try again. 

No immediate action; 
segment program. 

No immediate action; 
Charge ORG or 
segment program. 

Clear memory? 
Restart at l*li52.1 to 
try again. 

No immediate action; 
Reduce equivalences. 

Deletion or correction 
action. 

No immediate action; 
Restart at 1*7 21* .1 will 
ignore Constant but 
will cause Halt in 
Second Pass to 651*5.1 

To ignore, use START. 



To ignore, use START 
(address of assembled 
instruction will be 
0000.0) . 

See following para- 
graph. 



1*513.0 
7777.0 



"END FIRST PASS" 
Punching of Leader 



MEANING 
Same 
End of Second Pass 



U* 



LOCATION INDICATION MEANING 

0000.0 None End of SAVE 

d. Paper Tape may be re-read if necessary by moving the tape 
back to the last gap and then restarting at 5311.0. The 
gap has the following punching: 



Direction of tape movement 



... data F bbbbbbbbbbb S bbb C/R 00077L bbb 
Gap of 11 
blanks 

Such incomplete reads are occasionally caused by shiny 
spots on tape. A shiny spot which will cause a misread 
of a carriage return will cause a branch to zero (and 
a halt to zero). The cause of the halt may be checked 
by examining the tape in the reader to determine if it 
has stopped on a gap, if not a shiny spot may have caused 
the halt. The possibility of restart and re-read after 
blackening the shiny spot allows for the salvaging of 
the assembly operation. Further minor correction of the 
program may be necessary and may be accomplished by use 
of the correction, insertion, and deletion provisions 
detailed in paragraph 5. 
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SIGNAL CORPS RECOMP ASSEMBLY PROGRAM, SCRAP 11 

APPENDIX 1 1 
KEYPUNCHING 





ORG 


N 


1000 


CU3ER00T 


SAX 




X 




ADD 


D 


+ 1+39 




STA 




ERROR 




ADD 


D 


+ 1+39 




STA 




NORMAL 




XAR 


N 







STO 




X+l 




FCA 


F 


+ 1.0 




FST 




RESULT 




SL 






LOOP 


FSQ 




X 


ERROR 


TOV 


N 







FST 




X 




FSQ 




X 




FST 




X 




FMP 




RESULT 




FST 




RESULT 




FCA 




X 




FSB 


F 


+ 1«0 




EXT 


C 


-7777771+7777771 




FAD 


• F 


+0.0000000001 




TMI 




LOOP 




SL 








FCA 




RESULT 


NORMAL 


TRA 


N 





RESULT 


DECIMAL 


F 


-0 


w 
A 


DECIMAL 
END 


F 


-0 


L77000 








4> 











APPENDIX 1 1 




FIRST PASS 


OF ASSEMBLY 


LOCATION 


COMMAND 


ADDRESS 




ORG 


+ 1000 


CUBEROOT 


SAX 


X 




ADD 


(+1+39) 




STA 


ERROR 




ADD 


(+1+39) 




STA 


NORMAL 




XAR 


+0 




STO 


X+l 




FCA 


(+1.0) 




FST 


RESULT 




SL 




LOOP 


FSQ 


X 


ERROR 


TOV 


+0 




FST 


X 




FSQ 


X 




FST 


X 




FMP 


RESULT 




FST 


RESULT 




FCA 


X 




FSB 


(+1.0) 




EXT 


-777777I+777777I) 
(+0.0000000001) 




FAD 




TMI 


LOOP 




SL 






FCA 


RESULT 


NORMAL 


TRA 


+0 


RESULT 


DECIMAL 


-0) 


X 


DECIMAL 
END 


(-0) 


FiXCNOl 


+1+39 




FLOCNOl 


+1,0 




COMCNOl 


-7777771+7777771 


FL0CN02 


+0.0000000001 


CUBEROOT 


+0000000- 


-0010000 


X 


+0000000- 


-0010160 


ERROR 


+0000000- 


-0010051 


NORMAL 


+0000000- 


-0010131 


RESULT 


+0000000- 


-0010140 


LOOP 


+0000000- 


-0010050 


FIXCNOl 


+0000000- 


-0010200 


FLOCNOl 


+0000000- 


-0010210 


COMCNOl 


+0000000- 


-0010230 
-0010240 


FL0CN02 


+0000000- 


ENDTABLE 


+0000000- 


-0010260 



END FIRST PASS 



APPENDIX II 
SECOND PASS OF ASSEMBLY 



LOCATION 


COMMAND 


ADDRESS 




ORG 


+1000 


CUBEROOT 


SAX 


X 




ADD 


FIXCN01 




STA 


ERROR 




ADD 


FIXCN01 




STA 


NORMAL 




XAR 


40 




STO 


X+1 




FCA 


FLOCNOI 




FST 


RESULT 




SL 




LOOP 


FSQ 


X 


ERROR 


TOV 


+0 




FST 


X 




FSQ 


X 




FST 


X 




FMP 


RESULT 




FST 


RESULT 




FCA 


X 




FSB 


FLOCNOI 




EXT 


COMCNOI 




FAD 


FL0CN02 




TMI 


LOOP 




FCA 


RESULT 


NORMAL 


TRA 


+0 


RESULT 


DECIMAL 


(-0) 


X 


DECIMAL 


(-0) 


F1XCN01 


DEC 1 MAL 


(+1+3?) 

(+1.0) 


FLOCNOI 


DECIMAL 


COMCNOI 


COMMAND 


(-77777 

(+0,000i 


FL0CN02 


DECIMAL 



LI 0000 

+1510160+0110200 
+^2 1005 1+0 110200 
+4210131+4300000 
+6010170+3010210 

+35ioi4o+4oooooo 

+4410160+5300000 

+35101 6o44ioi 60 

+3510160+0710140 

+3510140+3010160 

+0610210+3310230 

+0410240+5110050 

+3010140+5700000 
-0000000-0000000 
-0000000-0000000 
-0000000-0000000 
-0000000-0000000 
+0000000-0000001 

+4000000-0000000 
+0000000-0000001 

-7777771+7777771 

+6700000-0000000 

-0000000-0000201 



END 



